SANDS OF FAITH v1.7

NOTE: 

- The folder PLAYER WARCRIES AND VOICE ORDERS has crusader and muslim version for voice on commands and warcries 
  and also crusader female voice, choose the one you want and copy/paste the wav files to sounds folder and sounds.txt 
  to Sands of Faith folder, 
replace when asked. To perform a warcry press "N".

- The folder USER INTERFACE has optional muslim ui, if you want to change copy/paste the .dds file to Sands of Faith 
  Textures folder and replace.

- The folder FACTION RELATIONS has optional faction relations, if you prefer to start a game with Ayyubids and Seljuks 
  at war copy/paste the appropriate factions.txt to Sands of Faith folder and replace.

- By default companions you make lords have Teutonic map icon, if you want to change open the txt file Companions 
  Optional Map Icons in Sands of Faith folder, copy the one you want, open map_icons.txt and almost at beginning replace 
  ikon_tevton_knight with the one you have chosen.

MAIN FEATURES:

- Advanced diplomacy system (Diplomacy 4.3)
- Abillity to join faction armies as a knight (Freelancer)
- Advanced formations system (PBOD)
- Start as one of the faction leaders or lords or just an adventurer, you chose
- New animations, scenes, graphics, audio
- Epic and voice acted battles (including immersive warcry for player)
- Sea travel and battles
- Ability to duel the greatest knights in the Holy Land
- Ability to play as one of your companions in battles (Custom Commander)
- Ability to chose between "battle continuation" camera or to play as one of the regular troops on death (Auxiliary Palyer)
- Advanced trade system, including sea trade, merchant ledger, bank system, trade with caravans, moneylenders and landowners
- Proper Middle-East map
- Proper faction banners and map icons (map icon for player is determined by the horse equipped)
- Create Teutonic Knights Order
- Events with choice and consequences
- Advanced tournament system (Tournament Play Enhancement)
- Realistic recruitment system and historical troop trees
- Historical names for both characters and settlements
- Historical armors and weapons
- Build your own outpost/fort anywhere in the map
- Play fun card game with tavern keepers and try to earn money
- Tons of other great features for you to discover

RECRUITMENT SYSTEM: 

Knights are not part of the troop tree and can only be recruited in towns and you need to be a lord to see the option and 
even then only knights from your faction, in towns owned by your faction will join. Knights can be upgraded once to the 
faction specific knight. Each knight cost 10x more than a normal recruit (100 denars vs 10 denars). The recruitment system 
for normal troops is similar however as only villages from your faction we'll have volunteers. There are no restrictions to 
recruit mercenaries (recruitable in taverns) but they're expensive and of worse quality. Special and unique troops can only 
be recruit if you own one of the 6 initial capital towns. Battlefield Priests, Bishops, Muftis and Grandmuftis are special 
units that are weak in combat but have party skills. Lower tier ones add to Wound Treatment while higher tier ones add to 
Surgery and Leadership. The more of these units you have the more bonus points you get to a maximum of 3, Leadership however 
is not cumulative and you don't get more than 1 point.

CREATING TEUTONIC KNIGHTS: 

Although technically you can create a random faction as in vanilla and other mods, this mod is optimized for the creation 
of Teutonic Knights. You create a new faction as usually, although you need to own a town (castle is not enough), then 
replace the default minister with a companion, get a chancellor and ask to change culture and choose Teutonic Knights. 
Wait like 2/3 days too so that it gets updated. Companions you make lords will have teutonic gear and banner, but before 
make them lords remove all items from inventory and what they have equipped to guarantee they equip teutonic gear. 
All you need to do either than that is giving the name to the faction and get the teutonic banner. Teutonic gear 
for yourself you can get from Jerusalem and Antioch stores. There are 3 companions wandering the Holy Land that perfectly 
fit to be Teutonic lords, they're easy to recognize with their German names (actually the names of the 3 first 
Teutonic Grandmasters).

CULTURAL STORES:

Items you can find in stores depends on the faction. Some items are shared with few other factions (like crusader generic 
items are shared among all crusader factions), but faction specific items you can only find in that faction store.

KNOWN BUGS AND ISSUES:

- If you enable Auxiliary Player don't chose to change commander because the scripts conflict and will bug your game!

- If you enable Auxiliary Player when you die and at the moment you replace a random soldier it will show some warning red 
  lines, it shall be harmless.

- When freelancing as knight, after being captured you were supposed to rejoin the lord but you don't get the option in 
  dialog, so just ask to leave and then ask to join again. If you don't find him after few days you'll leave automatically.

- There are at least 2 towns that when on your ship and trying to land that clicking on the town doesn't do anything, just 
  click on the village/castle closer to it.

- Sometimes when trying to enter a fort the game will crash, this is a bit random but helps waiting a day after upgrading
  it and after loading a save. In any case save your game before enter a fort.

- (MAC SEEMS TO HAVE ISSUES WITH THE CUSTOM SHADERS) If you have a MAC or can't read the font or just don't like it, delete FONT_DATA.XML from data folder and FONT.DDS from
  textures folder in Sands of Faith folder to revert to vanilla.

- Having several outposts and trying to destroy one can crash the game and corrupt the save (ideally avoid use the destroy
  function since is uncertain how extensive can this bug be).

- When starting as king or lord if you don't replace the character name (you can replace with the exact same name of course) 
  there is at least a little bug is that other parties when refering to you like "following xxx" or "running from xxx" it 
  doesn't show any name, so just reenter the same name if you want to keep it.

- Sometimes in the campaign map log it will show hours instead of the name of the lord when defeated in a battle for example,
  this is harmless.

- Autosell and autoupgrade for companions is bugged, don't use it.

- Spear bracing doesn't work, don't use it.

IMPORTANT INFORMATION:

- Press "I" to see Troop Ratio Bar, after using orders panel it will revert to the mini map.

- Press "N" to perform a warcry.

- Press "M" to call your horse.

- When on your ship if you go to camp menu you'll have the option to "try to catch some fish", this is related to foraging 
  skill.

- Press "T" key while wearing an "Helm" to get helmet view, you need to use also "R" key to change to 1st person view to get
  the proper view. Pressing "T" key again should reverse the helmet view but when on battle is bugged so press "Esc" to go 
  to "Options Menu" and then back to battle and it will reverse.

- The default vassal title when you're a faction leader is Baron, just go to camp menu / manage your kingdom / custom vassal 
  title and replace with the the one you want.

- In taverns if you talk to the tavern keeper, you can choose to play an interesting game called "Find the Lady", you might
  get lucky and earn some denars or get greedy and lose everything.

- When starting the game as King or Lord either than the troops you have in your party, you also have a complete army in 
  your town or castle, so go there and chose manage this town or castle, manage garrison and get all the troops you need.

- Talk to your Chancellor to set your kingdom policy if you're not getting money from your fiefs.

- Before start playing go to camp menu and look at all options available, there are tons to tweak your gameplay, most of 
  the behavior in this mod is optional. Also for ai to use formations properly (if you want to check it) you must also 
  put ai setting at maximum in Diplomacy options.

- You need to replace your default Minister with a companion to unlock all the special dialog options.

- You can trade with caravans.

SOURCE CODE PERMISSION CONDITIONS:

- Cannot be used as base for a mod about the same theme as this one (the crusades)
- Cannot use any sea battle scenes, towns, castles or Anatolia villages (basically the ones in Sultanate of Rum territory) 
  without permission of el xabeo de la cova from Hispania 1200 (this includes exteriors and interiors, arenas and taverns)
- Give credit where it's due

SPECIAL THANKS TO:

- Akathir for the great Jerusalem town
- Bismarck for Native Module Compilation that I used as base module system with Diplomacy and Custom Commander merged
- Feyd1979 for the great map
- el xabeo de la cova for the release of the source code with his mod Hispania 1200 wich made possible the integration 
  of the script to start as king/lord and many other scripts and to allow me to use Hispania 1200 scenes, all credits to 
  him for all the new scenes (towns, castles, villages, sea battles, lairs, meeting scenes),  many scripts and few icons 
  and items 
- Crusaders Way To Expiation Team for the release of their great work which is the graphical backbone of this mod, all 
  credits to them for almost all items, battlefield scenes, interface, textures, icons, shaders, flora, terrain borders, 
  skyboxes, font and some sounds in this mod
- Goodfutter for doing crusader voices on purpose for this mod (also to Matmohair1 for the arabian voices pack)
- produno from A World of Ice and Fire for the help editing the campaign map
- ElPadrino for Sands of Faith dedicated ENB

CREDITS:

Hispania 1200, Crusaders Way To Expiation Team, 1257 AD, Brytenwalda, Wings of Glory, Crusader Deus Vult, Native Expansion, 
Tocans Calradia, Gekokujo, 1429 la Guerre de Cent Ans, Native Module Compilation,Floris

Akathir, el xabeo de la cova, Feyd1979, Bismarck, Waihti, rubik, taragoth, Caba'drin, Windyplains, motomataru, Jinnai, Arch3r, 
MartinF, Anardion, Checkmaty, lucky lancer, Tempered, einhar, Almansur, CounterPoint, Lumos, Lav, sphere, Duh, 
Ruthven, lazeras, Papa Lazarou, Iboltax, Slawomir of Aaarrgh, Jacobhinds, dunde, Shcherbyna, AndyYa, 
Goodfutter, Matmohair1, Ibidil, FantasyWarrior, Mark7, Melphiz, KuauiK, DrThomas, Sayd Uthman, Zimke Zlovoljni, Mikeboix, 
BlackDeer, TheFatty, zedpaolo, Nordous, produno, ElPadrino, HyperCharge

INSTALLATION:

- Extract to your Mount&Blade Warband/Modules folder
- Choose Sands of Faith v1.7 on the launcher mods list
- Play and have fun